<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
    "http://www.w3.org/TR/1998/REC-html40-19980424/loose.dtd">
<html><head>
    <title>NSHost(HostIPLookup)</title>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta name="generator" content="HeaderDoc">
<style type="text/css"><!--a:link {text-decoration: none; font-family: lucida grande, geneva, helvetica, arial, sans-serif; font-size: small; color: #0000ff;}a:visited {text-decoration: none; font-family: lucida grande, geneva, helvetica, arial, sans-serif; font-size: small; color: #0000ff;}a:visited:hover {text-decoration: underline; font-family: lucida grande, geneva, helvetica, arial, sans-serif; font-size: small; color: #ff6600;}a:active {text-decoration: none; font-family: lucida grande, geneva, helvetica, arial, sans-serif; font-size: small; color: #ff6600;}a:hover {text-decoration: underline; font-family: lucida grande, geneva, helvetica, arial, sans-serif; font-size: small; color: #ff6600;}h4 {text-decoration: none; font-family: lucida grande, geneva, helvetica, arial, sans-serif; font-size: tiny; font-weight: bold;}body {text-decoration: none; font-family: lucida grande, geneva, helvetica, arial, sans-serif; font-size: 10pt;}--></style></head><body bgcolor="#ffffff">
<h1><font face="Geneva,Arial,Helvtica">NSHost(HostIPLookup)</font></h1><br>
<a name="//apple_ref/doc/class/NSHost(HostIPLookup)" title="NSHost(HostIPLookup)"></a>
<h2>Abstract</h2>
 Adds IP geolocation capabilities to the NSHost class.
<h2>Discussion</h2>
 The HostIPLookup category adds IP geolocation capabilities to the NSHost class.
Lookups can be cached in order to avoid network overhead when repeatedly accessing the same data.
Of course you can flush the cache anytime and even disable it. Beware though that this will slow
down things.
 <hr><br><h2>Methods</h2>
<a name="HeaderDoc_methods"></a>
<dl>
<dt><tt><a href="CompositePage.html#//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/city" target="_top">-city</a></tt></dt>
<dd>Returns the city name for the receiver.
 </dd>
<dt><tt><a href="CompositePage.html#//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/country" target="_top">-country</a></tt></dt>
<dd>Returns the country name for the receiver.
 </dd>
<dt><tt><a href="CompositePage.html#//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/countryCode" target="_top">-countryCode</a></tt></dt>
<dd>Returns the country code for the receiver.
 </dd>
<dt><tt><a href="CompositePage.html#//apple_ref/doc/compositePage/occ/clm/NSHost(HostIPLookup)/flushGeolocationCache" target="_top">+flushGeolocationCache</a></tt></dt>
<dd>Causes the cache for NSHost geolocation data to be emptied.
 </dd>
<dt><tt><a href="CompositePage.html#//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/geodata" target="_top">-geodata</a></tt></dt>
<dd>Returns full geodata information for the receiver.
 </dd>
<dt><tt><a href="CompositePage.html#//apple_ref/doc/compositePage/occ/clm/NSHost(HostIPLookup)/isGeolocationCacheEnabled" target="_top">+isGeolocationCacheEnabled</a></tt></dt>
<dd>Returns <tt>YES</tt> if the cache for NSHost geolocation data is enabled.
 </dd>
<dt><tt><a href="CompositePage.html#//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/latitude" target="_top">-latitude</a></tt></dt>
<dd>Returns the value of the latitude for the receiver.
 </dd>
<dt><tt><a href="CompositePage.html#//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/longitude" target="_top">-longitude((BOOL))</a></tt></dt>
<dd>Returns the value of the longitude for the receiver.
 </dd>
<dt><tt><a href="CompositePage.html#//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/longitude" target="_top">-longitude((BOOL))</a></tt></dt>
<dd>Returns the value of the latitude for the receiver.
 </dd>
<dt><tt><a href="CompositePage.html#//apple_ref/doc/compositePage/occ/clm/NSHost(HostIPLookup)/setGeolocationCacheEnabled:" target="_top">+setGeolocationCacheEnabled:</a></tt></dt>
<dd>Enables or disables the cache for NSHost geolocation data.
</dd>
</dl>
<hr><!-- headerDoc=instm;  uid=//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/city;  name=NSHost(HostIPLookup)::city -->
<a name="//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/city"></a>
<table border="0"  cellpadding="2" cellspacing="2" width="300"><tr><td valign="top" height="12" colspan="5"><h3><a name="city">city</a></h3>
</td></tr></table><hr><dl></dl><p>Returns the city name for the receiver.
 </p>
<blockquote><pre>- (<!-- a logicalPath="//apple_ref/occ/cl/NSString //apple_ref/occ/cl/NSString //apple_ref/occ/tdef/NSString //apple_ref/occ/tag/NSString //apple_ref/occ/econst/NSString //apple_ref/occ/struct/NSString //apple_ref/occ/clconst/NSString" --><font class="type">NSString</font><!-- /a --> <font class="type">*</font>)<font class="param">city</font>;</pre></blockquote>
<dl></dl>
<hr><!-- headerDoc=instm;  uid=//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/country;  name=NSHost(HostIPLookup)::country -->
<a name="//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/country"></a>
<table border="0"  cellpadding="2" cellspacing="2" width="300"><tr><td valign="top" height="12" colspan="5"><h3><a name="country">country</a></h3>
</td></tr></table><hr><dl></dl><p>Returns the country name for the receiver.
 </p>
<blockquote><pre>- (<!-- a logicalPath="//apple_ref/occ/cl/NSString //apple_ref/occ/cl/NSString //apple_ref/occ/tdef/NSString //apple_ref/occ/tag/NSString //apple_ref/occ/econst/NSString //apple_ref/occ/struct/NSString //apple_ref/occ/clconst/NSString" --><font class="type">NSString</font><!-- /a --> <font class="type">*</font>)<font class="param">country</font>;</pre></blockquote>
<dl></dl>
<hr><!-- headerDoc=instm;  uid=//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/countryCode;  name=NSHost(HostIPLookup)::countryCode -->
<a name="//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/countryCode"></a>
<table border="0"  cellpadding="2" cellspacing="2" width="300"><tr><td valign="top" height="12" colspan="5"><h3><a name="countryCode">countryCode</a></h3>
</td></tr></table><hr><dl></dl><p>Returns the country code for the receiver.
 </p>
<blockquote><pre>- (<!-- a logicalPath="//apple_ref/occ/cl/NSString //apple_ref/occ/cl/NSString //apple_ref/occ/tdef/NSString //apple_ref/occ/tag/NSString //apple_ref/occ/econst/NSString //apple_ref/occ/struct/NSString //apple_ref/occ/clconst/NSString" --><font class="type">NSString</font><!-- /a --> <font class="type">*</font>)<font class="param">countryCode</font>;</pre></blockquote>
<dl></dl>
<hr><!-- headerDoc=clm;  uid=//apple_ref/doc/compositePage/occ/clm/NSHost(HostIPLookup)/flushGeolocationCache;  name=NSHost(HostIPLookup)::flushGeolocationCache -->
<a name="//apple_ref/doc/compositePage/occ/clm/NSHost(HostIPLookup)/flushGeolocationCache"></a>
<table border="0"  cellpadding="2" cellspacing="2" width="300"><tr><td valign="top" height="12" colspan="5"><h3><a name="flushGeolocationCache">flushGeolocationCache</a></h3>
</td></tr></table><hr><dl></dl><p>Causes the cache for NSHost geolocation data to be emptied.
 </p>
<blockquote><pre>+ (<!-- a logicalPath="//apple_ref/occ/cl/void //apple_ref/occ/cl/void //apple_ref/occ/tdef/void //apple_ref/occ/tag/void //apple_ref/occ/econst/void //apple_ref/occ/struct/void //apple_ref/occ/clconst/void" --><font class="type">void</font><!-- /a -->)<font class="param">flushGeolocationCache</font>;</pre></blockquote>
<dl></dl>
<hr><!-- headerDoc=instm;  uid=//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/geodata;  name=NSHost(HostIPLookup)::geodata -->
<a name="//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/geodata"></a>
<table border="0"  cellpadding="2" cellspacing="2" width="300"><tr><td valign="top" height="12" colspan="5"><h3><a name="geodata">geodata</a></h3>
</td></tr></table><hr><dl></dl><p>Returns full geodata information for the receiver.
 </p>
<blockquote><pre>- (<!-- a logicalPath="//apple_ref/occ/cl/NSString //apple_ref/occ/cl/NSString //apple_ref/occ/tdef/NSString //apple_ref/occ/tag/NSString //apple_ref/occ/econst/NSString //apple_ref/occ/struct/NSString //apple_ref/occ/clconst/NSString" --><font class="type">NSString</font><!-- /a --> <font class="type">*</font>)<font class="param">geodata</font>;</pre></blockquote>
<dl></dl>
<hr><!-- headerDoc=clm;  uid=//apple_ref/doc/compositePage/occ/clm/NSHost(HostIPLookup)/isGeolocationCacheEnabled;  name=NSHost(HostIPLookup)::isGeolocationCacheEnabled -->
<a name="//apple_ref/doc/compositePage/occ/clm/NSHost(HostIPLookup)/isGeolocationCacheEnabled"></a>
<table border="0"  cellpadding="2" cellspacing="2" width="300"><tr><td valign="top" height="12" colspan="5"><h3><a name="isGeolocationCacheEnabled">isGeolocationCacheEnabled</a></h3>
</td></tr></table><hr><dl></dl><p>Returns <tt>YES</tt> if the cache for NSHost geolocation data is enabled.
 </p>
<blockquote><pre>+ (<!-- a logicalPath="//apple_ref/occ/cl/BOOL //apple_ref/occ/cl/BOOL //apple_ref/occ/tdef/BOOL //apple_ref/occ/tag/BOOL //apple_ref/occ/econst/BOOL //apple_ref/occ/struct/BOOL //apple_ref/occ/clconst/BOOL" --><font class="type">BOOL</font><!-- /a -->)<font class="param">isGeolocationCacheEnabled</font>;</pre></blockquote>
<dl></dl>
<hr><!-- headerDoc=instm;  uid=//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/latitude;  name=NSHost(HostIPLookup)::latitude -->
<a name="//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/latitude"></a>
<table border="0"  cellpadding="2" cellspacing="2" width="300"><tr><td valign="top" height="12" colspan="5"><h3><a name="latitude">latitude</a></h3>
</td></tr></table><hr><dl></dl><p>Returns the value of the latitude for the receiver.
 </p>
<b>See Also:</b><br><blockquote><dl>
<dt><!-- a logicalPath="//apple_ref/occ/instm/NSHost(HostIPLookup)/longitude" -->longitude<!-- /a --></dt><dd></dd></dl></blockquote>
<blockquote><pre>- (<!-- a logicalPath="//apple_ref/occ/cl/float //apple_ref/occ/cl/float //apple_ref/occ/tdef/float //apple_ref/occ/tag/float //apple_ref/occ/econst/float //apple_ref/occ/struct/float //apple_ref/occ/clconst/float" --><font class="type">float</font><!-- /a -->)<font class="param">latitude</font>;</pre></blockquote>
<dl></dl>
<hr><!-- headerDoc=instm;  uid=//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/longitude;  name=NSHost(HostIPLookup)::longitude -->
<a name="//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/longitude"></a>
<table border="0"  cellpadding="2" cellspacing="2" width="300"><tr><td valign="top" height="12" colspan="5"><h3><a name="longitude((BOOL))">longitude((BOOL))</a></h3>
</td></tr></table><hr><dl></dl><p>Returns the value of the longitude for the receiver.
 </p>
<blockquote><pre>- (<!-- a logicalPath="//apple_ref/occ/cl/float //apple_ref/occ/cl/float //apple_ref/occ/tdef/float //apple_ref/occ/tag/float //apple_ref/occ/econst/float //apple_ref/occ/struct/float //apple_ref/occ/clconst/float" --><font class="type">float</font><!-- /a -->)<font class="param">longitude</font>;</pre></blockquote>
<dl></dl>
<hr><!-- headerDoc=instm;  uid=//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/longitude;  name=NSHost(HostIPLookup)::longitude -->
<a name="//apple_ref/doc/compositePage/occ/instm/NSHost(HostIPLookup)/longitude"></a>
<table border="0"  cellpadding="2" cellspacing="2" width="300"><tr><td valign="top" height="12" colspan="5"><h3><a name="longitude((BOOL))">longitude((BOOL))</a></h3>
</td></tr></table><hr><dl></dl><p>Returns the value of the latitude for the receiver.
 </p>
<b>See Also:</b><br><blockquote><dl>
<dt><!-- a logicalPath="//apple_ref/occ/instm/NSHost(HostIPLookup)/latitude" -->latitude<!-- /a --></dt><dd></dd></dl></blockquote>
<blockquote><pre>- (<!-- a logicalPath="//apple_ref/occ/cl/float //apple_ref/occ/cl/float //apple_ref/occ/tdef/float //apple_ref/occ/tag/float //apple_ref/occ/econst/float //apple_ref/occ/struct/float //apple_ref/occ/clconst/float" --><font class="type">float</font><!-- /a -->)<font class="param">latitude</font>;</pre></blockquote>
<dl></dl>
<hr><!-- headerDoc=clm;  uid=//apple_ref/doc/compositePage/occ/clm/NSHost(HostIPLookup)/setGeolocationCacheEnabled:;  name=NSHost(HostIPLookup)::setGeolocationCacheEnabled: -->
<a name="//apple_ref/doc/compositePage/occ/clm/NSHost(HostIPLookup)/setGeolocationCacheEnabled:"></a>
<table border="0"  cellpadding="2" cellspacing="2" width="300"><tr><td valign="top" height="12" colspan="5"><h3><a name="setGeolocationCacheEnabled:">setGeolocationCacheEnabled:</a></h3>
</td></tr></table><hr><dl></dl><p>Enables or disables the cache for NSHost geolocation data.
</p>
<blockquote><pre>+ (<!-- a logicalPath="//apple_ref/occ/cl/void //apple_ref/occ/cl/void //apple_ref/occ/tdef/void //apple_ref/occ/tag/void //apple_ref/occ/econst/void //apple_ref/occ/struct/void //apple_ref/occ/clconst/void" --><font class="type">void</font><!-- /a -->)<!-- a logicalPath="//apple_ref/occ/instm/setGeolocationCacheEnabled //apple_ref/occ/clm/setGeolocationCacheEnabled //apple_ref/occ/intfcm/setGeolocationCacheEnabled //apple_ref/occ/func/setGeolocationCacheEnabled //apple_ref/occ/ftmplt/setGeolocationCacheEnabled //apple_ref/occ/defn/setGeolocationCacheEnabled //apple_ref/occ/macro/setGeolocationCacheEnabled" --><font class="function">setGeolocationCacheEnabled</font><!-- /a -->:(<!-- a logicalPath="//apple_ref/occ/cl/BOOL //apple_ref/occ/cl/BOOL //apple_ref/occ/tdef/BOOL //apple_ref/occ/tag/BOOL //apple_ref/occ/econst/BOOL //apple_ref/occ/struct/BOOL //apple_ref/occ/clconst/BOOL" --><font class="type">BOOL</font><!-- /a -->)<font class="param">enabled</font>;</pre></blockquote>
<h5><font face="Lucida Grande,Helvetica,Arial">Parameter Descriptions</font></h5>
<blockquote>
<dl>
<dt><code><i>enabled</i></code></dt><dd>Pass <tt>YES</tt> to enable the cache, <tt>NO</tt> to disable it.</dd>
</dl>
</blockquote>
<dl></dl>
<p>(Last Updated April 29, 2008)
</p></body></html>
